Serviço Federal de 
Processamento de Dados 


API Serpro 


Documentação de APIs 


Abaixo são apresentadas a documentação e a demonstração das APIs disponibilizadas 
pelo Serpro. 


As APIs disponibilizadas pela plataforma API Serpro utilizam o protocolo Oauth2 para 
realizar a autenticação e autorização de acesso das APIs contratadas. 

> Primeiro Passo 

Para consumir as APIs, você deverá utilizar os dois códigos (Consumer Key e 
Consumer Secret) disponibilizados na Área do Cliente. Esses códigos servem para 
identificar o contrato. 

Exemplos de códigos: 

Consumer Key: djaR21PGoYp1iyK2n2ACOH9REdUb 
Consumer Secret: 0bRsAJW0L4fv2Tp27D1vd8fB30te 

> Segundo Passo 

Para consultar as APIs, é necessário obter um token de acesso temporário (Bearer). 
Esse token possui um tempo de validade e sempre que expirado, este passo de 
requisição de um novo token de acesso deve ser repetido. 


Como solicitar o Token de Acesso (Bearer): 

Para consultar as APIs disponibilizadas pelo SERPRO, é necessário obter um 
token de acesso temporário (Bearer). Esse token possui um tempo de validade e 
sempre que expirado, este passo de requisição de um novo token de acesso deve 
ser repetido. 

Para solicitar o token temporário é necessário realizar uma requisição HTTP POST 
para o endpoint Token https://apigateway.serpro.gov.br/token, informando as 
credenciais de acesso (consumerKey:consumerSecret) no HTTP Header 
Authorization, no formato base64, conforme exemplo abaixo. 

As credenciais de acesso devem ser obtidas a partir do portal do cliente Serpro - 
https://minhaconta.serpro.gov.br 

[POST] grant_type=client_credentials 

[HEAD] Authorization: Basic base64(Consumer Key:Consumer 
Secret) 

Abaixo segue um exemplo de chamada via cUrI: 

curl -k -d "grant_type=client_credentials" -H "Authorization: 
Basic 

ZGphUjIxUEdvWXAxaXlLMm4yQUNPSDlSRWRVYj pPYlJzQUpXTOwOZnYyVHAyN 
0QxdmQ4ZkIzT3RlCg" 

https://apigateway.serpro.gov.br/token 
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A chave informada no exemplo acima “ZGphUjlxUEdvWXAxaXILMm4yQUNPSD 
ISRWRVYjpPYIJzQUpXT0w0ZnYyVHAyN0QxdmQ4ZklzT3RICg” é resultado do 
BASE64 dos códigos Consumer Key e Consumer Secret separados pelo caracter 
conforme exemplo a seguir: 

echo -n 

"djaR21PGoYpliyK2n2AC0H9REdUb;0bRsAJW0L4fv2Tp27Dlvd8fB30te" | 
base64 


> Terceiro Passo 

Como resultado do passo anterior, o endpoint informará o token de acesso a API, no 
campo access_token da mensagem json de retorno. Este token deve ser informado nos 
próximos passos. 


Receba o Token: 

Como resultado, o endpoint informará o token de acesso a API, no campo 
access_token da mensagem json de retorno. Este token deve ser informado nos 
próximos passos. 

{"scope":"am_application_scope 
default","token_type":"Bearer", 

"expires_in":3295, 

"access_token":"C66a7deflc96f7008a0c397dc588b6d7"} 


Renovação do Token de Acesso: 

Atentar que sempre que o token de acesso temporário expirar, o gateway vai 
retornar um HTTP CODE 401 após realizar uma requisição para uma API. Neste 
caso, deve ser repetido o passo anteriormente descrito no Segundo Passo (Como 
solicitar o Token de Acesso - Bearer) para geração de um novo token de acesso 
temporário. 


> Quarto Passo 

De posse do Token de Acesso, faça a requisição a um dos serviços da API 
contratada/desejada. 


Realizando consulta ãs APIs: 

De posse do Token de Acesso, faça a requisição a um dos serviços, por exemplo 
da API CPF: 

curl -X GET --header "Accept: application/json" 
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--header "Authorization; Bearer 
4elal858bdd584fdc077fb7d80f39283" 


"https://apigateway.serpro.gov.br/consulta- 
cpf/vl/99999999999" 

No exemplo acima foram utilizados os seguintes parâmetros: 

[HEADER] Accept: application/json - Informamos o tipo de dados que estamos 
requerendo, nesse caso JSON 

[HEADER] Authorization: Bearer 4e1a1858bdd584fdc077fb7d80f39283 - 
Informamos o token de acesso recebido 

[GET] https://apigateway.serpro.gov.br/consulta-cpf/v1/cpf/99999999999: 
chamamos a uri da API informando o CPF. No caso a uri é “consulta-cpf/v1/cpf/ 
{numero do CPF}” 

Nesse caso, espera-se que a estrutura da resposta seja a seguinte (exemplo): 


{ 

"ni" : "91708635203" 


"nome" ; "Nome do CPF 917.086.352-03", 
"nascimento" : "01011975", 

"situacao" : { 

"codigo" : "0", 

"descricao" : "Regular" 


} 


} 


IMPORTANTE: 


✓ A chamada à consulta da API CPF acima é apenas um exemplo. 

✓ As APIs disponíveis e suas respectivas URLs (endpoints) para consumo são 
disponibilizadas (através da documentação dos seus respectivos swaggers) na 
seção TESTE na página de sua respectiva APIs. 


Clique aqui para acessar a Biblioteca de APIs Serpro! 
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